home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / slrenam5.arc / SLRENAM5.DOC < prev    next >
Text File  |  1991-12-22  |  6KB  |  162 lines
  1.    SLRENAME 1.5 - Turn handles into real names for SL export and vice versa
  2.           -----------------------------------------------------
  3.  
  4. (c)1991 Glen Johnson. All Rights Reserved
  5.  
  6. This program was written with Searchlight BBS systems running SLMAIL to
  7. export echomail messages to *.MSG format in mind.
  8.  
  9. Version 1.5 allows you to use the program on export or import. The config
  10. file name is now specified on the command line along with which path to
  11. scan. This allows you to use the program with two config files exactly
  12. the opposite of each other so that you can convert handles to real names
  13. on export, and real names to handles on import.
  14.  
  15.  
  16. New for version 1.5
  17. ===================
  18.  
  19. Version 1.5 supports up to 512 entries in the config file. The program also
  20. sets the DOS ERRORLEVEL when it exits. The value of ERRORLEVEL will be equal
  21. to the number of messages SLRENAME has changed. This will allow you to trap
  22. an errorlevel in a batch file and do something based on it. If more than
  23. 255 message files have been changed, the ERRORLEVEL is set to 255.
  24.  
  25. 1.5 is also released as a shareware product. Registration is $15. The
  26. registered version has no "unregistered" screens, and doesn't beg you to
  27. register. The unregistered version is fully functional, and is batch capable.
  28.  
  29. A note about 1.4
  30. ================
  31.  
  32. Those of you that got 1.4 should upgrade. 1.4, although very similar to this
  33. version, had a couple of minor bugs in it, and you couldn't run it in a batch
  34. file. Try 1.5 out . If you like it, REGISTER it and you'll like it a whole lot
  35. more.
  36.  
  37.  
  38. Overview:
  39.  
  40. This program is an interim solution to a limitation of the SLMAIL program.
  41. SLMAIL, when exporting messages from Searchlight's message base, will
  42. look for messages from SYSOP and create the resulting .MSG file with
  43. whatever name you specify in the SLMAIL.CFG file. Unfortunately, it ONLY
  44. looks for messages from SYSOP, not from anyone else.
  45.  
  46. Many Fidonet backbone conferences, including the SEARCHLIGHT conference,
  47. do not allow the use of handles or aliases. This creates a dilemma for
  48. Searchlight sysops in that no conference moderator has the right to tell
  49. any BBS operator that he can't allow his users to use a handle or alias
  50. on his BBS. So if you run a Searchlight BBS, carry the SEARCHLIGHT echomail
  51. conference or any other conference that prohibits the use of handles,
  52. and you let your users use handles on your BBS, you're basically faced with
  53. two choices. 1) You don't allow your users access to the conference, or
  54. 2) You let users with handles access the conference and risk having your
  55. link cut.
  56.  
  57. This program can give you some relief...
  58.  
  59. SLRENAME will scan .MSG files created by SLMAIL, look for a name in
  60. the From: field of the message, and change it to whatever name you want.
  61.  
  62. How to make it go:
  63.  
  64. Calling syntax:
  65.  
  66. SLRENAME <drive\path\configfilename> <drive:\messagepath\>
  67.  
  68. example:
  69.  
  70. SLRENAME EXPORT.CFG C:\ECHOS\SEARCHLIGHT\
  71.  
  72. The program will scan C:\ECHOS\SEARCHLIGHT\ for messages to process.
  73. It will use EXPORT.CFG for its config file.
  74.  
  75. The config file
  76. ---------------
  77.  
  78. SLRENAME will read the configuration file specified on the command line
  79. for the names to convert. For example:
  80.  
  81. Bob Jones=MANIAC
  82. Steve Smith=BONEHEAD
  83.  
  84. If those two lines are in your configuration file, all the messages that
  85. have MANIAC in the From: field of the message, will have that handle replaced
  86. with Bob Jones. Likewise, messages from BONEHEAD will be replaced with Steve
  87. Smith. You can have up to 512 entries in the config file. Note that the equal
  88. sign is important, don't forget it. Also, the config file is CASE SENSITIVE.
  89.  
  90. Hints and stuff
  91. ---------------
  92.  
  93. To convert handles to real names when exporting messages from Searchlight
  94. into Fido land, create a file called EXPORT.CFG (or use whatever filename
  95. you like) and make it look like this:
  96.  
  97. Bob Jones=MANIAC MAN
  98.  
  99. IMMEDIATELY after doing your SLMAIL export, run SLRENAME:
  100.  
  101. SLRENAME EXPORT.CFG G:\ECHOS\SL\
  102.  
  103. SLRENAME will scan G:\ECHOS\SL\ for .MSG files . It will change the
  104. name in the message header of each .MSG from MANIAC MAN to Bob Jones,
  105. if it finds any. You can then use your fidonet mail tosser to export/scan
  106. and pack up the outgoing mail.
  107.  
  108.  
  109. To convert real names in incoming messages to handles so that you can
  110. put them INTO Searchlight, make a config file called IMPORT.CFG (or
  111. whatever name you like) and make it exactly the OPPOSITE of EXPORT.CFG .
  112. Like this:
  113.  
  114. MANIAC MAN=Bob Jones
  115.  
  116. Run SLRENAME immediately BEFORE doing an SLMAIL IMPORT:
  117.  
  118. SLRENAME IMPORT.CFG G:\ECHOS\SL\
  119.  
  120. SLRENAME will take any .MSG file addressed to Bob Jones, and re-address
  121. it to MANIAC MAN. You may now do your SLMAIL IMPORT and move the .MSG
  122. files into Searchlight's message base.
  123.  
  124. Remember, when importing, do SLRENAME then the next program you run is
  125. SLMAIL in import mode. When exporting, do your SLMAIL in export mode
  126. FIRST, THEN SLRENAME with your exporting config file.
  127.  
  128. Two sample config files are included in this archive so you get the idea
  129. better.
  130.  
  131.  
  132. Disclaimer
  133. ----------
  134.  
  135. This is a copyrighted work by Glen Johnson. You are free to use it,
  136. and distribute it provided that you make no changes to it, and provided
  137. that this documentation accompanies the software.
  138.  
  139. A version of this software is available to those who register the program,
  140. that doesn't nag you to register. Registration is $15 US funds. Send
  141. your money order to Glen Johnson, PO Box 60, Convent Station NJ 07961.
  142.  
  143. This program works just fine on my system, it may not on yours. Use of this
  144. program is ENTIRELY at your own risk. If you're not willing to accept
  145. full responsibility for what happens to your system as a direct or indirect
  146. result of using this program, DON'T use it. I assume no responsibility
  147. for its performance, fitness for a particular purpose, and assume no
  148. liability for damages, direct or indirect, incurred as a result of using
  149. or misusing this program. This software is provided as-is.
  150.  
  151. Closing argument
  152. ----------------
  153.  
  154. When Frank LaRosa gets around to changing SLMAIL to handle these functions,
  155. this program will become instantly obsolete. So, I probably won't enhance it
  156. much. Now that it will do imports AND exports, I can't imagine the need to
  157. enhance it any further, but who knows.  Have fun.
  158.  
  159.  
  160. Glen Johnson
  161. 1:2605/269@fidonet
  162.